home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / pyshared / lazr.uri-1.0.egg-info / PKG-INFO < prev    next >
Text File  |  2009-06-15  |  6KB  |  175 lines
  1. Metadata-Version: 1.0
  2. Name: lazr.uri
  3. Version: 1.0
  4. Summary: This is a template for your lazr package.  To start your own lazr package,
  5. Home-page: https://launchpad.net/lazr.uri
  6. Author: LAZR Developers
  7. Author-email: lazr-developers@lists.launchpad.net
  8. License: LGPL v3
  9. Download-URL: https://launchpad.net/lazr.uri/+download
  10. Description: ..
  11.         This file is part of lazr.uri.
  12.         
  13.         lazr.uri is free software: you can redistribute it and/or modify it
  14.         under the terms of the GNU Lesser General Public License as published by
  15.         the Free Software Foundation, version 3 of the License.
  16.         
  17.         lazr.uri is distributed in the hope that it will be useful, but
  18.         WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  19.         or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
  20.         License for more details.
  21.         
  22.         You should have received a copy of the GNU Lesser General Public License
  23.         along with lazr.uri.  If not, see <http://www.gnu.org/licenses/>.
  24.         
  25.         lazr.uri
  26.         ********
  27.         
  28.         The lazr.uri package includes code for parsing and dealing with URIs.
  29.         
  30.         >>> import lazr.uri
  31.         >>> print 'VERSION:', lazr.uri.__version__
  32.         VERSION: ...
  33.         
  34.         =============
  35.         The URI class
  36.         =============
  37.         
  38.         >>> from lazr.uri import URI
  39.         >>> uri1 = URI('http://localhost/foo/bar?123')
  40.         >>> uri2 = URI('http://localhost/foo/bar/baz')
  41.         >>> uri1.contains(uri2)
  42.         True
  43.         
  44.         These next two are equivalent, so the answer should be True, even through
  45.         the "outside" one is shorter than the "inside" one.
  46.         
  47.         >>> uri1 = URI('http://localhost/foo/bar/')
  48.         >>> uri2 = URI('http://localhost/foo/bar')
  49.         >>> uri1.contains(uri2)
  50.         True
  51.         
  52.         The next two are exactly the same.  We consider a url to be inside itself.
  53.         
  54.         >>> uri1 = URI('http://localhost/foo/bar/')
  55.         >>> uri2 = URI('http://localhost/foo/bar/')
  56.         >>> uri1.contains(uri2)
  57.         True
  58.         
  59.         In the next case, the string of url2 starts with the string of url1.  But,
  60.         because url2 continues within the same path step, url2 is not inside url1.
  61.         
  62.         >>> uri1 = URI('http://localhost/foo/ba')
  63.         >>> uri2 = URI('http://localhost/foo/bar')
  64.         >>> uri1.contains(uri2)
  65.         False
  66.         
  67.         Here, url2 is url1 plus an extra path step.  So, url2 is inside url1.
  68.         
  69.         >>> uri1 = URI('http://localhost/foo/bar/')
  70.         >>> uri2 = URI('http://localhost/foo/bar/baz')
  71.         >>> uri1.contains(uri2)
  72.         True
  73.         
  74.         Once the URI is parsed, its parts are accessible.
  75.         
  76.         >>> uri = URI('https://fish.tree:8666/blee/blah')
  77.         >>> uri.scheme
  78.         'https'
  79.         >>> uri.host
  80.         'fish.tree'
  81.         >>> uri.port
  82.         '8666'
  83.         >>> uri.authority
  84.         'fish.tree:8666'
  85.         >>> uri.path
  86.         '/blee/blah'
  87.         
  88.         >>> uri = URI('https://localhost/blee/blah')
  89.         >>> uri.scheme
  90.         'https'
  91.         >>> uri.host
  92.         'localhost'
  93.         >>> uri.port is None
  94.         True
  95.         >>> uri.authority
  96.         'localhost'
  97.         >>> uri.path
  98.         '/blee/blah'
  99.         
  100.         The grammar from RFC 3986 does not allow for square brackets in the
  101.         query component, but Section 3.4 does say how such delimeter
  102.         characters should be handled if found in the component.
  103.         
  104.         >>> uri = URI('http://www.apple.com/store?delivery=[slow]#horse+cart')
  105.         >>> uri.scheme
  106.         'http'
  107.         >>> uri.host
  108.         'www.apple.com'
  109.         >>> uri.port is None
  110.         True
  111.         >>> uri.path
  112.         '/store'
  113.         >>> uri.query
  114.         'delivery=[slow]'
  115.         >>> uri.fragment
  116.         'horse+cart'
  117.         
  118.         ====================
  119.         Finding URIs in Text
  120.         ====================
  121.         
  122.         lazr.uri also knows how to retrieve a list of URIs from a block of
  123.         text.  This is intended for uses like finding bug tracker URIs or
  124.         similar.
  125.         
  126.         The find_uris_in_text() function returns an iterator that yields URI
  127.         objects for each URI found in the text.  Note that the returned URIs
  128.         have been canonicalised by the URI class:
  129.         
  130.         >>> from lazr.uri import find_uris_in_text
  131.         >>> text = '''
  132.         ... A list of URIs:
  133.         ...  * http://localhost/a/b
  134.         ...  * http://launchpad.net
  135.         ...  * MAILTO:joe@example.com
  136.         ...  * xmpp:fred@example.org
  137.         ...  * http://bazaar.launchpad.net/%7ename12/firefox/foo
  138.         ...  * http://somewhere.in/time?track=[02]#wasted-years
  139.         ... '''
  140.         
  141.         >>> for uri in find_uris_in_text(text):
  142.         ...     print uri
  143.         http://localhost/a/b
  144.         http://launchpad.net/
  145.         mailto:joe@example.com
  146.         xmpp:fred@example.org
  147.         http://bazaar.launchpad.net/~name12/firefox/foo
  148.         http://somewhere.in/time?track=[02]#wasted-years
  149.         
  150.         ===============
  151.         Other Documents
  152.         ===============
  153.         
  154.         .. toctree::
  155.         :glob:
  156.         
  157.         *
  158.         docs/*
  159.         
  160.         =================
  161.         NEWS for lazr.uri
  162.         =================
  163.         
  164.         1.0 (2009-03-23)
  165.         ================
  166.         
  167.         - Initial release on PyPI
  168.         
  169. Platform: UNKNOWN
  170. Classifier: Development Status :: 5 - Production/Stable
  171. Classifier: Intended Audience :: Developers
  172. Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
  173. Classifier: Operating System :: OS Independent
  174. Classifier: Programming Language :: Python
  175.